OpenEdge Getting Started:<br />New and Revised Features Logging Improvements

Release 10.1A expands the existing logging infrastructure to support User logging, 4GLTrace logging enhancements, Query Info logging enhancements, and logging for classes in the Progress 4GL.

4GLTrace logging enhancements

4GLTrace logging logs an entry message when execution of an internal procedure, user-defined function, persistent user-interface trigger, named events, classes, methods, PUBLISH statement, and SUBSCRIBE statement begins. 4GLTrace logging logs a to indicate the application returned.

User logging

In OpenEdge Release 10.1A, the LOG-MANAGER system handle provides functionality to clear and close the client log file for interactive and batch clients, and allows all clients to write application messages to the log file. The new methods for the LOG-MANAGER system handle method include:

CLEAR-LOG( ) — Clears all messages existing in the current client log file and leaves the file open for writing.

CLOSE-LOG( ) — Stops an interactive or batch client from writing messages to the current log file, and closes the log file.

WRITE-MESSAGE( ) — Writes user messages to the current log file.

Additionally, the Use Clear Log (-clearlog) startup parameter deletes any file that matches the name of the specified client log file identified by the Client Logging (-clientlog) parameter.

Event logging enhancement

Event logging logs several categories of events. The OpenEdge-generated events now include Developer Events (U1 through U10). Additionally, the information logged includes the name and line number of the routine (.p or .w file or method) and internal procedure based on the Debugger listing file.

Query Info logging enhancements

Query Info logging helps developers evaluate query execution and efficiency. Release 10.1A provides the following enhancements:

Identifies all indices used in queries.

Identifies field lists used in queries.

Logs read access statistics for all tables and indices used in queries.

Logging support for classes in the Progress 4GL

Release 10.1A includes support for logging classes. The new log entry type DynObjects.Class logs the creation and deletion of classes. Additionally, the information logged includes the .p or .w file or method where the object was created or destroyed.

4GLTrace logging logs the instantiation of classes (generated by the NEW statement), the invocation of super classes and methods (generated by the METHOD invocation syntax), and the deletion of classes (generated by the DELETE OBJECT statement).